home *** CD-ROM | disk | FTP | other *** search
/ Freelog 22 / freelog 22.iso / Prog / Djgpp / DJDEV203.ZIP / include / dpmi.h < prev    next >
Encoding:
C/C++ Source or Header  |  1999-08-04  |  15.8 KB  |  350 lines

  1. /* Copyright (C) 1999 DJ Delorie, see COPYING.DJ for details */
  2. /* Copyright (C) 1995 DJ Delorie, see COPYING.DJ for details */
  3. #ifndef __dj_include_dpmi_h_
  4. #define __dj_include_dpmi_h_
  5.  
  6. #ifdef __cplusplus
  7. extern "C" {
  8. #endif
  9.  
  10. #ifndef __dj_ENFORCE_ANSI_FREESTANDING
  11.  
  12. #ifndef __STRICT_ANSI__
  13.  
  14. #ifndef _POSIX_SOURCE
  15.  
  16. extern unsigned short __dpmi_error;
  17.  
  18. typedef struct {
  19.   unsigned short offset16;
  20.   unsigned short segment;
  21. } __dpmi_raddr;
  22.  
  23. typedef struct {
  24.   unsigned long  offset32;
  25.   unsigned short selector;
  26. } __dpmi_paddr;
  27.  
  28. typedef struct {
  29.   unsigned long handle;            /* 0, 2 */
  30.   unsigned long size;     /* or count */    /* 4, 6 */
  31.   unsigned long address;        /* 8, 10 */
  32. } __dpmi_meminfo;
  33.  
  34. typedef union {
  35.   struct {
  36.     unsigned long edi;
  37.     unsigned long esi;
  38.     unsigned long ebp;
  39.     unsigned long res;
  40.     unsigned long ebx;
  41.     unsigned long edx;
  42.     unsigned long ecx;
  43.     unsigned long eax;
  44.   } d;
  45.   struct {
  46.     unsigned short di, di_hi;
  47.     unsigned short si, si_hi;
  48.     unsigned short bp, bp_hi;
  49.     unsigned short res, res_hi;
  50.     unsigned short bx, bx_hi;
  51.     unsigned short dx, dx_hi;
  52.     unsigned short cx, cx_hi;
  53.     unsigned short ax, ax_hi;
  54.     unsigned short flags;
  55.     unsigned short es;
  56.     unsigned short ds;
  57.     unsigned short fs;
  58.     unsigned short gs;
  59.     unsigned short ip;
  60.     unsigned short cs;
  61.     unsigned short sp;
  62.     unsigned short ss;
  63.   } x;
  64.   struct {
  65.     unsigned char edi[4];
  66.     unsigned char esi[4];
  67.     unsigned char ebp[4];
  68.     unsigned char res[4];
  69.     unsigned char bl, bh, ebx_b2, ebx_b3;
  70.     unsigned char dl, dh, edx_b2, edx_b3;
  71.     unsigned char cl, ch, ecx_b2, ecx_b3;
  72.     unsigned char al, ah, eax_b2, eax_b3;
  73.   } h;
  74. } __dpmi_regs;
  75.   
  76. typedef struct {
  77.   unsigned char  major;
  78.   unsigned char  minor;
  79.   unsigned short flags;
  80.   unsigned char  cpu;
  81.   unsigned char  master_pic;
  82.   unsigned char  slave_pic;
  83. } __dpmi_version_ret;
  84.  
  85. typedef struct {
  86.   unsigned long largest_available_free_block_in_bytes;
  87.   unsigned long maximum_unlocked_page_allocation_in_pages;
  88.   unsigned long maximum_locked_page_allocation_in_pages;
  89.   unsigned long linear_address_space_size_in_pages;
  90.   unsigned long total_number_of_unlocked_pages;
  91.   unsigned long total_number_of_free_pages;
  92.   unsigned long total_number_of_physical_pages;
  93.   unsigned long free_linear_address_space_in_pages;
  94.   unsigned long size_of_paging_file_partition_in_pages;
  95.   unsigned long reserved[3];
  96. } __dpmi_free_mem_info;
  97.  
  98. typedef struct {
  99.   unsigned long total_allocated_bytes_of_physical_memory_host;
  100.   unsigned long total_allocated_bytes_of_virtual_memory_host;
  101.   unsigned long total_available_bytes_of_virtual_memory_host;
  102.   unsigned long total_allocated_bytes_of_virtual_memory_vcpu;
  103.   unsigned long total_available_bytes_of_virtual_memory_vcpu;
  104.   unsigned long total_allocated_bytes_of_virtual_memory_client;
  105.   unsigned long total_available_bytes_of_virtual_memory_client;
  106.   unsigned long total_locked_bytes_of_memory_client;
  107.   unsigned long max_locked_bytes_of_memory_client;
  108.   unsigned long highest_linear_address_available_to_client;
  109.   unsigned long size_in_bytes_of_largest_free_memory_block;
  110.   unsigned long size_of_minimum_allocation_unit_in_bytes;
  111.   unsigned long size_of_allocation_alignment_unit_in_bytes;
  112.   unsigned long reserved[19];
  113. } __dpmi_memory_info;
  114.  
  115. typedef struct {
  116.   unsigned long data16[2];
  117.   unsigned long code16[2];
  118.   unsigned short ip;
  119.   unsigned short reserved;
  120.   unsigned long data32[2];
  121.   unsigned long code32[2];
  122.   unsigned long eip;
  123. } __dpmi_callback_info;
  124.  
  125. typedef struct {
  126.   unsigned long size_requested;
  127.   unsigned long size;
  128.   unsigned long handle;
  129.   unsigned long address;
  130.   unsigned long name_offset;
  131.   unsigned short name_selector;
  132.   unsigned short reserved1;
  133.   unsigned long reserved2;
  134. } __dpmi_shminfo;
  135.  
  136. /* Unless otherwise noted, all functions return -1 on error, setting __dpmi_error to the DPMI error code */
  137.  
  138. void    __dpmi_yield(void);                                    /* INT 0x2F AX=1680 */
  139.  
  140. int    __dpmi_allocate_ldt_descriptors(int _count);                        /* DPMI 0.9 AX=0000 */
  141. int    __dpmi_free_ldt_descriptor(int _descriptor);                        /* DPMI 0.9 AX=0001 */
  142. int    __dpmi_segment_to_descriptor(int _segment);                        /* DPMI 0.9 AX=0002 */
  143. int    __dpmi_get_selector_increment_value(void);                        /* DPMI 0.9 AX=0003 */
  144. int    __dpmi_get_segment_base_address(int _selector, unsigned long *_addr);            /* DPMI 0.9 AX=0006 */
  145. int    __dpmi_set_segment_base_address(int _selector, unsigned long _address);            /* DPMI 0.9 AX=0007 */
  146. unsigned long __dpmi_get_segment_limit(int _selector);                        /* LSL instruction  */
  147. int    __dpmi_set_segment_limit(int _selector, unsigned long _limit);                /* DPMI 0.9 AX=0008 */
  148. int    __dpmi_get_descriptor_access_rights(int _selector);                    /* LAR instruction  */
  149. int    __dpmi_set_descriptor_access_rights(int _selector, int _rights);            /* DPMI 0.9 AX=0009 */
  150. int    __dpmi_create_alias_descriptor(int _selector);                        /* DPMI 0.9 AX=000a */
  151. int    __dpmi_get_descriptor(int _selector, void *_buffer);                    /* DPMI 0.9 AX=000b */
  152. int    __dpmi_set_descriptor(int _selector, void *_buffer);                    /* DPMI 0.9 AX=000c */
  153. int    __dpmi_allocate_specific_ldt_descriptor(int _selector);                    /* DPMI 0.9 AX=000d */
  154.  
  155. int    __dpmi_get_multiple_descriptors(int _count, void *_buffer);                /* DPMI 1.0 AX=000e */
  156. int    __dpmi_set_multiple_descriptors(int _count, void *_buffer);                /* DPMI 1.0 AX=000f */
  157.  
  158. int    __dpmi_allocate_dos_memory(int _paragraphs, int *_ret_selector_or_max);            /* DPMI 0.9 AX=0100 */
  159. int    __dpmi_free_dos_memory(int _selector);                            /* DPMI 0.9 AX=0101 */
  160. int    __dpmi_resize_dos_memory(int _selector, int _newpara, int *_ret_max);            /* DPMI 0.9 AX=0102 */
  161.  
  162. int    __dpmi_get_real_mode_interrupt_vector(int _vector, __dpmi_raddr *_address);        /* DPMI 0.9 AX=0200 */
  163. int    __dpmi_set_real_mode_interrupt_vector(int _vector, __dpmi_raddr *_address);        /* DPMI 0.9 AX=0201 */
  164. int    __dpmi_get_processor_exception_handler_vector(int _vector, __dpmi_paddr *_address);    /* DPMI 0.9 AX=0202 */
  165. int    __dpmi_set_processor_exception_handler_vector(int _vector, __dpmi_paddr *_address);    /* DPMI 0.9 AX=0203 */
  166. int    __dpmi_get_protected_mode_interrupt_vector(int _vector, __dpmi_paddr *_address);    /* DPMI 0.9 AX=0204 */
  167. int    __dpmi_set_protected_mode_interrupt_vector(int _vector, __dpmi_paddr *_address);    /* DPMI 0.9 AX=0205 */
  168.  
  169. int    __dpmi_get_extended_exception_handler_vector_pm(int _vector, __dpmi_paddr *_address);    /* DPMI 1.0 AX=0210 */
  170. int    __dpmi_get_extended_exception_handler_vector_rm(int _vector, __dpmi_paddr *_address);    /* DPMI 1.0 AX=0211 */
  171. int    __dpmi_set_extended_exception_handler_vector_pm(int _vector, __dpmi_paddr *_address);    /* DPMI 1.0 AX=0212 */
  172. int    __dpmi_set_extended_exception_handler_vector_rm(int _vector, __dpmi_paddr *_address);    /* DPMI 1.0 AX=0213 */
  173.  
  174. int    __dpmi_simulate_real_mode_interrupt(int _vector, __dpmi_regs *_regs);            /* DPMI 0.9 AX=0300 */
  175. int    __dpmi_int(int _vector, __dpmi_regs *_regs); /* like above, but sets ss sp fl */    /* DPMI 0.9 AX=0300 */
  176. extern short __dpmi_int_ss, __dpmi_int_sp, __dpmi_int_flags; /* default to zero */
  177. int    __dpmi_simulate_real_mode_procedure_retf(__dpmi_regs *_regs);                /* DPMI 0.9 AX=0301 */
  178. int    __dpmi_simulate_real_mode_procedure_retf_stack(__dpmi_regs *_regs, int stack_words_to_copy, const void *stack_data); /* DPMI 0.9 AX=0301 */
  179. int    __dpmi_simulate_real_mode_procedure_iret(__dpmi_regs *_regs);                /* DPMI 0.9 AX=0302 */
  180. int    __dpmi_allocate_real_mode_callback(void (*_handler)(void), __dpmi_regs *_regs, __dpmi_raddr *_ret); /* DPMI 0.9 AX=0303 */
  181. int    __dpmi_free_real_mode_callback(__dpmi_raddr *_addr);                    /* DPMI 0.9 AX=0304 */
  182. int    __dpmi_get_state_save_restore_addr(__dpmi_raddr *_rm, __dpmi_paddr *_pm);        /* DPMI 0.9 AX=0305 */
  183. int    __dpmi_get_raw_mode_switch_addr(__dpmi_raddr *_rm, __dpmi_paddr *_pm);            /* DPMI 0.9 AX=0306 */
  184.  
  185. int    __dpmi_get_version(__dpmi_version_ret *_ret);                        /* DPMI 0.9 AX=0400 */
  186.  
  187. int    __dpmi_get_capabilities(int *_flags, char *vendor_info);                /* DPMI 1.0 AX=0401 */
  188.  
  189. int    __dpmi_get_free_memory_information(__dpmi_free_mem_info *_info);            /* DPMI 0.9 AX=0500 */
  190. int    __dpmi_allocate_memory(__dpmi_meminfo *_info);                        /* DPMI 0.9 AX=0501 */
  191. int    __dpmi_free_memory(unsigned long _handle);                        /* DPMI 0.9 AX=0502 */
  192. int    __dpmi_resize_memory(__dpmi_meminfo *_info);                        /* DPMI 0.9 AX=0503 */
  193.  
  194. int    __dpmi_allocate_linear_memory(__dpmi_meminfo *_info, int _commit);            /* DPMI 1.0 AX=0504 */
  195. int    __dpmi_resize_linear_memory(__dpmi_meminfo *_info, int _commit);            /* DPMI 1.0 AX=0505 */
  196. int    __dpmi_get_page_attributes(__dpmi_meminfo *_info, short *_buffer);            /* DPMI 1.0 AX=0506 */
  197. int    __dpmi_set_page_attributes(__dpmi_meminfo *_info, short *_buffer);            /* DPMI 1.0 AX=0507 */
  198. int    __dpmi_map_device_in_memory_block(__dpmi_meminfo *_info, unsigned long _physaddr);    /* DPMI 1.0 AX=0508 */
  199. int    __dpmi_map_conventional_memory_in_memory_block(__dpmi_meminfo *_info, unsigned long _physaddr); /* DPMI 1.0 AX=0509 */
  200. int    __dpmi_get_memory_block_size_and_base(__dpmi_meminfo *_info);                /* DPMI 1.0 AX=050a */
  201. int    __dpmi_get_memory_information(__dpmi_memory_info *_buffer);                /* DPMI 1.0 AX=050b */
  202.  
  203. int    __dpmi_lock_linear_region(__dpmi_meminfo *_info);                    /* DPMI 0.9 AX=0600 */
  204. int    __dpmi_unlock_linear_region(__dpmi_meminfo *_info);                    /* DPMI 0.9 AX=0601 */
  205. int    __dpmi_mark_real_mode_region_as_pageable(__dpmi_meminfo *_info);            /* DPMI 0.9 AX=0602 */
  206. int    __dpmi_relock_real_mode_region(__dpmi_meminfo *_info);                    /* DPMI 0.9 AX=0603 */
  207. int    __dpmi_get_page_size(unsigned long *_size);                        /* DPMI 0.9 AX=0604 */
  208.  
  209. int    __dpmi_mark_page_as_demand_paging_candidate(__dpmi_meminfo *_info);            /* DPMI 0.9 AX=0702 */
  210. int    __dpmi_discard_page_contents(__dpmi_meminfo *_info);                    /* DPMI 0.9 AX=0703 */
  211.  
  212. int    __dpmi_physical_address_mapping(__dpmi_meminfo *_info);                    /* DPMI 0.9 AX=0800 */
  213. int    __dpmi_free_physical_address_mapping(__dpmi_meminfo *_info);                /* DPMI 0.9 AX=0801 */
  214.  
  215. /* These next four functions return the old state */
  216. int    __dpmi_get_and_disable_virtual_interrupt_state(void);                    /* DPMI 0.9 AX=0900 */
  217. int    __dpmi_get_and_enable_virtual_interrupt_state(void);                    /* DPMI 0.9 AX=0901 */
  218. int    __dpmi_get_and_set_virtual_interrupt_state(int _old_state);                /* DPMI 0.9 AH=09   */
  219. int    __dpmi_get_virtual_interrupt_state(void);                        /* DPMI 0.9 AX=0902 */
  220.  
  221. int    __dpmi_get_vendor_specific_api_entry_point(char *_id, __dpmi_paddr *_api);        /* DPMI 0.9 AX=0a00 */
  222.  
  223. int    __dpmi_set_debug_watchpoint(__dpmi_meminfo *_info, int _type);                /* DPMI 0.9 AX=0b00 */
  224. int    __dpmi_clear_debug_watchpoint(unsigned long _handle);                    /* DPMI 0.9 AX=0b01 */
  225. int    __dpmi_get_state_of_debug_watchpoint(unsigned long _handle, int *_status);        /* DPMI 0.9 AX=0b02 */
  226. int    __dpmi_reset_debug_watchpoint(unsigned long _handle);                    /* DPMI 0.9 AX=0b03 */
  227.  
  228. int    __dpmi_install_resident_service_provider_callback(__dpmi_callback_info *_info);        /* DPMI 1.0 AX=0c00 */
  229. int    __dpmi_terminate_and_stay_resident(int return_code, int paragraphs_to_keep);        /* DPMI 1.0 AX=0c01 */
  230.  
  231. int    __dpmi_allocate_shared_memory(__dpmi_shminfo *_info);                    /* DPMI 1.0 AX=0d00 */
  232. int    __dpmi_free_shared_memory(unsigned long _handle);                    /* DPMI 1.0 AX=0d01 */
  233. int    __dpmi_serialize_on_shared_memory(unsigned long _handle, int _flags);            /* DPMI 1.0 AX=0d02 */
  234. int    __dpmi_free_serialization_on_shared_memory(unsigned long _handle, int _flags);        /* DPMI 1.0 AX=0d03 */
  235.  
  236. int    __dpmi_get_coprocessor_status(void);                            /* DPMI 1.0 AX=0e00 */
  237. int    __dpmi_set_coprocessor_emulation(int _flags);                        /* DPMI 1.0 AX=0e01 */
  238.  
  239. /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
  240. /* Backwards compatibility stuff                               */
  241.  
  242. #define _go32_dpmi_registers            __dpmi_regs
  243.  
  244. typedef struct {
  245.   unsigned long available_memory;
  246.   unsigned long available_pages;
  247.   unsigned long available_lockable_pages;
  248.   unsigned long linear_space;
  249.   unsigned long unlocked_pages;
  250.   unsigned long available_physical_pages;
  251.   unsigned long total_physical_pages;
  252.   unsigned long free_linear_space;
  253.   unsigned long max_pages_in_paging_file;
  254.   unsigned long reserved[3];
  255. } _go32_dpmi_meminfo;
  256.  
  257. #define _go32_dpmi_get_free_memory_information(x) __dpmi_get_free_memory_information((__dpmi_free_mem_info *)(x))
  258.  
  259. #define _go32_dpmi_simulate_int        __dpmi_simulate_real_mode_interrupt
  260. #define _go32_dpmi_simulate_fcall    __dpmi_simulate_real_mode_procedure_retf
  261. #define _go32_dpmi_simulate_fcall_iret    __dpmi_simulate_real_mode_procedure_iret
  262.  
  263. typedef struct {
  264.   unsigned long size;
  265.   unsigned long pm_offset;
  266.   unsigned short pm_selector;
  267.   unsigned short rm_offset;
  268.   unsigned short rm_segment;
  269. } _go32_dpmi_seginfo;
  270.  
  271. /* returns zero if success, else dpmi error and info->size is max size */
  272. int _go32_dpmi_allocate_dos_memory(_go32_dpmi_seginfo *info);
  273.     /* set size to bytes/16, call, use rm_segment.  Do not
  274.        change anthing but size until the memory is freed.
  275.        If error, max size is returned in size as bytes/16. */
  276. int _go32_dpmi_free_dos_memory(_go32_dpmi_seginfo *info);
  277.     /* set new size to bytes/16, call.  If error, max size
  278.        is returned in size as bytes/16 */
  279. int _go32_dpmi_resize_dos_memory(_go32_dpmi_seginfo *info);
  280.     /* uses pm_selector to free memory */
  281.  
  282. /* These both use the rm_segment:rm_offset fields only */
  283. int _go32_dpmi_get_real_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  284. int _go32_dpmi_set_real_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  285.  
  286. /* These do NOT wrap the function in pm_offset in an iret handler.
  287.    You must provide an assembler interface yourself, or alloc one below.
  288.    You may NOT longjmp out of an interrupt handler. */
  289. int _go32_dpmi_get_protected_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  290.     /* puts vector in pm_selector:pm_offset. */
  291. int _go32_dpmi_set_protected_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  292.     /* sets vector from pm_offset and pm_selector */
  293.  
  294. /********** HELPER FUNCTIONS **********/
  295.  
  296. int _go32_dpmi_chain_protected_mode_interrupt_vector(int vector, _go32_dpmi_seginfo *info);
  297.     /* sets up wrapper that calls function in pm_offset, chaining to old
  298.        handler when it returns */
  299.  
  300. /* These generate assember IRET-style wrappers for functions and set up stack */
  301. int _go32_dpmi_allocate_iret_wrapper(_go32_dpmi_seginfo *info);
  302.     /* Put function ptr in pm_offset, call, returns wrapper entry in pm_offset. */
  303. int _go32_dpmi_free_iret_wrapper(_go32_dpmi_seginfo *info);
  304.     /* assumes pm_offset points to wrapper, frees it */
  305.  
  306. /* RMCB functions, automatically restructure the real-mode stack for the 
  307.    proper return type and set up correct PM stack.  The callback
  308.    (info->pm_offset) is called as (*pmcb)(_go32_dpmi_registers *regs); */
  309. int _go32_dpmi_allocate_real_mode_callback_retf(_go32_dpmi_seginfo *info, _go32_dpmi_registers *regs);
  310.     /* points callback at pm_offset, returns seg:ofs of callback addr
  311.        in rm_segment:rm_offset.  Do not change any fields until freed.
  312.        Interface is added to simulate far return */
  313. int _go32_dpmi_allocate_real_mode_callback_iret(_go32_dpmi_seginfo *info, _go32_dpmi_registers *regs);
  314.     /* same, but simulates iret */
  315. int _go32_dpmi_free_real_mode_callback(_go32_dpmi_seginfo *info);
  316.     /* frees callback */
  317.  
  318. /* The following two variables may be used to change the default stack size
  319.    for interrupts and rmcb wrappers to a user defined size from the default
  320.    of 32Kbytes.  Each RMCB and chain/iret wrapper gets it's own stack. */
  321.  
  322. extern unsigned long _go32_interrupt_stack_size;
  323. extern unsigned long _go32_rmcb_stack_size;
  324.  
  325. /* Convenience functions, the return value is *bytes* */
  326. unsigned long _go32_dpmi_remaining_physical_memory(void);
  327. unsigned long _go32_dpmi_remaining_virtual_memory(void);
  328.  
  329. /* locks memory from a specified offset within the code/data selector */
  330. int _go32_dpmi_lock_code( void *_lockaddr, unsigned long _locksize);
  331. int _go32_dpmi_lock_data( void *_lockaddr, unsigned long _locksize);
  332.  
  333. int __djgpp_set_page_attributes(void *our_addr, unsigned long num_bytes,
  334.                     unsigned short attributes);
  335. int __djgpp_map_physical_memory(void *our_addr, unsigned long num_bytes,
  336.                     unsigned long phys_addr);
  337.  
  338. #endif /* !_POSIX_SOURCE */
  339. #endif /* !__STRICT_ANSI__ */
  340. #endif /* !__dj_ENFORCE_ANSI_FREESTANDING */
  341.  
  342. #ifndef __dj_ENFORCE_FUNCTION_CALLS
  343. #endif /* !__dj_ENFORCE_FUNCTION_CALLS */
  344.  
  345. #ifdef __cplusplus
  346. }
  347. #endif
  348.  
  349. #endif /* !__dj_include_dpmi_h_ */
  350.